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DETECTION OF RESOURCE EXCEPTIONS 



CROSS REFERENCE TO RELATED APPLICATIONS 

The present invention is related to the following U. S. 
Patent Applications which are incorporated herein by 
reference: 

Serial No. - (Attorney Docket No. 

AUS9-2000-0501-US1) entitled "Identifying Non-Externalized 
Text Strings That Are Not Hard-Coded" filed 

Serial No - (Attorney Docket No. 

AUS9-2000-0498-US1) entitled "Pre-Processing Code to Identify 
and Modify Format of Keys" filed • 

TECHNICAL FIELD 

The present invention relates to the field of 
internationalization, and more particularly to a scanning 
program that detects resource exception errors prior to the 
run-time of the application. 

BACKGROUND INFORMATION 

internationalization is a process of enabling a program, 
e g Java, to rtin internationally. That is, an 
internationalized program has the flexibility to run correctly 
in any country. An internationalized program must be able to 
read write and manipulate localized text. Furthermore, an 
internationalized program must conform to local customs when 
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displaying dates and times, formatting numbers and sorting 

strings. . 

internationalization is becoming increasingly important 

with the explosive growth of the Internet and the World Wide 
Web where an ever increasing number of computer users are from 
various locales. A locale represents a geographic, cultural 
or political region. One of the problems with 
internationalization involves the use of text strings that may 
be hard-coded in the program, e.g., Java. Hard-coded text 
strings refer to text that will not vary with the locale. 
That is, the text strings may appear in English even when the 
program is run on the French locale. Various object-oriented 
languages such as Java have developed tools to assist m 
developing internationalized programs and allowing text 
strings to appear in the language of the locale. A discussion 
of object-oriented programming languages and in particular 

Java is deemed appropriate. 

in an object-oriented programming language such as Java, 
a class is a collection of data and methods that operate on 
that data. The data and methods taken together describe the 
state and behavior of what is commonly referred to as an 
object An object in essence includes data and code where the 
code manipulates the data. Hence a software application may 
be written using an object-oriented programming language such 
as Java whereby the program's functionality is implemented 

using objects. ■-,.□•+. 
Unlike many programming languages, Java is compiled into 

machine independent code commonly referred to as bytecodes 

instead of machine dependent code, i.e. executable code. 

Bytecodes are stored in a particular file format commonly 

referred to as a "class file" that includes bytecodes for 

methods of a class. In addition to the bytecodes for methods 
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of , class, the class file includes , symbol file as well as 
ohhpr ancillary information. 

^computer program embodied as oava Recedes in one or 
more class files is pXatform independent. Th. colter 

m „v be executed, unmodified, on any computer that rs 

, Th 0 lava virtual machine is not an 

as a Java virtual machine. The Java vircu 

a tual hardware platform, but rather a low level softwar 
Viator that can be implemented on many different computer 
Z essor architectures and under many different operate 

terns. The Java virtual machine reads and interprets each 
bytecode so that the instructions may be executed by he 
Itive processor. Hence a ,ava bytecode „ capable of 
functioning on any platform that has a Java vrrtual machrne 
riementation available. However, bytecode interpretatron 
I cts from processor performance since the 
h as to spend some of its processing time rnt.rpr.trn by^de 
instructions. Compilers commonly referred to as ,ust 

a -improve the performance ot Java 
(JIT)" were developed to improve tne y 

a! machines. A JIT compiler translates Java by^eco d es 
into the processor's native machine code during runt me^ 
processor then executes the compiled native machine code. 

As stated above Java has developed tools to assist m 
aeveloping internationalized programs «^ 
strings to appear in the language of the locale. One such 

is the use of resource files commonly referred to m 
tool is the o resource bundle class may be used 

Java as resource bundles. A resource 

i • • „ crrinas i.e. messages. By 

for externalizing text strings, i.e ar _ Mr i n 

externalizing text strings, appropriate text "J^l 
t he language of th. locale. ^ o^atted 

associative array of keys and values. Keys are re 
strings that appear in the program code as well as rn 
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resource bundle thereby allowing the program to access the 
externalized string. Externalized strings may be represen d 
as a value associated with the key. That is, 
strings for a given locale are indexed by keys. Hence the 
program may access an externalized string by -ess, ng the 
value associated with the key in the resource bundle, i.e. the 
key that matches the key in the program code. By having 

• t-~,q ,.7it-Vi narticular locales, e.g., a 
resource bundles associated with particui* 

resource file with resources associated with the US nglish 
locale, a resource file with resources associated with the 
French locale and so forth, appropriate text strings 
associated with the particular locale may be loaded at 
runtime. 

Unfortunately, software developers may not define a 

rt r-n. ^ a resource bundle, or 
key-value pair in the resource file, e.g., 

■ - ^ kev i e free formatted string, in either the 
mistype the key, i' e - ucc , 

j ^ rpqnurce file source code thereby 
program code or the resource m« 

resulting in a resource exception error during the ™-t- 
the application, e.g.. Java. For example, a Key-value parr rn 
the Source £ile. e.g., resource bundle, may -t be defrned 
»hen there Is no Key or v.!ue associated with the Key rn e 
resource file, e.g., resource bundle. Furthermore, software 
developers may mistype the Key, i.e. free formatted string, m 
e her the program code or in the resource file source code so 
at the Key, i.e. free formatted string, in t**«~~£ 
and in the resource file source code do not match and thereby 
prevent the progra, from accessing the externalized strrng rn 
the resource file. When a procedure, commonly referred to as 
a method, in Java attempts to load an external strrng from the 
resource bundle and either the Key-value pair M not de rned 
in the resource file or the Key in either the program code or 
resource file source code is mistyped, a resource exception 
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error results. It would therefore be desirable to detect 
resource exception errors prior to the run-time of the 
application and subsequently define the key-value paxr rn the 

K.mril p or correct the mistyped 
resource file, e.g., resource bundle, or corr 

„ ra . mirce file source code so 
key in either the program code or resource 

as to avoid resource exception errors. 
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SUMMARY 



The probes outlined above «y at least in part be 
sol ved in see events by a scanning program «h t e t cts 

«.y,»t are used to open resource files to 
me thod invocations that ar -e , dentifying a method 

detect resource exception ^ signature , 

invocation, the scanning pr ogr« s cans 

i.e. pointer, associated with the ident ^ 
• nation The method signature points to the reso 
invocation. m« crannina program 

* k, t-hP method invocation. The scanning y 

" ^ "^ans for a pa ir of string delimiters adjacent to the 
further scan or ^ pair of string 

me thod signature^ The st g ^ ^ ^ ^ by ^ 

delimiters is a ^ o h ^ ^ ^ ^ 

method invocation. Once tne 

scanning program determines whether the key and v 
scanning p g ^ ^ regource flle . if 

associated with the key ^ ^ resource 

the key or its associated value is 
i e then a resource exception error is detected. 
£llS ' In one embodiment, a method for ^^J^^ 
options cerises the step o £ scanning a cod or a^ 
invocation used to open a resource He. The 

the step of identifying the method invocation 
comprises the step ^ cod(j f „ , 

method further comprises the step o 

method signature where the method signature points to the 
8 MttaJ invoca tion. The 

resource file to be opened y ^ ^ ^ a 

method further comprises the step o ^ 
pail of string delimiters , . key 

rrri::r - ^ *. - 

of the resour invocation 

of opening the resource file using th ^ 

identified to detect resource exception errors. 
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the associated value is not defined in the resource file, then 
a resource exception error is detected. 

In another embodiment of the present invention, the 
me thod comprises the step of generating a report ^ 
report may comprise a listing of all resource errors detected 
upon completing the scanning the code. fpatures 
The foregoing has outlined rather broadly the features 
and technical advantages of the present invention in order 
that the detailed description of the invents that f o 1 ow 
may be better understood. Additional features and ^vantages 
Tthe invention will be described hereinafter which form the 
subject of the claims of the invention. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

A better understanding of the present invention can be 
obtained when the following detailed description is considered 
in conjunction with the following drawings, in which: 

Figure 1 illustrates a data processing system configured 
in accordance with the present invention; 

Figure 2 is a flowchart of a method for detecting 

resource exception errors; and 

Figure 3 illustrates key-value pairs in resource files. 
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DETAILED DESCRIPTION 



The present invention comprises a method, computer 
program product and data processing system for detecting 
resource exception errors. In one embodiment of the present 
invention, a scanning program scans for a method invocation 
used to open a resource file. After identifying a method 
invocation, the scanning program scans for a method signature, 
i e. pointer, associated with the identified method 
invocation. The method signature points to the resource file 
to be opened by the method invocation. The scanning program 
further scans for a pair of string delimiters adjacent to the 
method signature. The string within the pair of string 
delimiters is a key to the resource file to be opened by the 
method invocation. Once the resource file is opened, the 
scanning program determines whether the key and the value 
associated with the key are defined in the resource file, 
the key or its associated value is not defined in the resource 
file, then a resource exception error is detected. In another 
embodiment of the present invention, a report may be generated 
where the report may comprise a listing of all resource errors 
detected upon completing the scanning the code. It is noted 
that even though the following discusses the present xnvention 
in conjunction with a Java programming environment the present 
invention may be implemented in any type of programming 
environment where the programming language has the capability 
of externalizing text strings in resource files. 
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Figure 1 illustrates a typical hardware conf iguration of 
data processing system 13 which is representative of a 
hardware environment for practicing the present 
Data processing system 13 has a central processxng unit (CPU) 
10 such as a conventional microprocessor, coupled to various 
other components by system bus 12. An operating system 40, 
eg DOS, OS/2™, runs on CPU 10 and provides control and 
coordinates the function of the various components of Figure 
1 An object-oriented programming system, such as Java 42, 
runs in conjunction with operating system 40 and provides 
output calls to operating system 40 which implements the 
various functions to be performed by the application 42 Read 
only memory (ROM) 16 is coupled to system bus 12 and includes 
a basic input/output system ("BIOS") that controls certain 
basic functions of data processing system 13. Random access 
memory (RAM) 14, I/O adapter 18, and communications adapter 
are also coupled to system bus 12. It should be noted that 
software components including operating system 40 and 
application 42 are loaded into RAM 14 which is the computer 

T/n adaDter 18 may be a small computer 
system's mam memory. I/O adapter y 

system interface ("SCSI") adapter that communicates with disk 
units 20, e.g., disk drive, and tape drives 40. It is noted 
that the scanning program of the present invention that 
detects resource exception errors may reside in disk unit 20 
or in application 42. Communications adapter 34 interconnects 
bus 12 with an outside network enabling data processing system 
13 to communication with other such systems. Input/Output 
devices are also connected to system bus 12 via a user 
interface adapter 22 and a display adapter 36. Keyboard 4 
trackball 28, mouse 26 and speaker 30 are all interconnected 
to bus 12 through user interface adapter 22. Event data may 
be input to the object-oriented programming system through any 
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of these devices. A display monitor 38 is connected to system 
bus 12 by display adapter 36. In this manner, a user is 
capable of inputting to system 13 through keyboard 24, 
trackball 28 or mouse 26 and receiving output from system 13 

via display 38 or speaker 30. 

Preferred implementations of the invention include 
lamentations as a computer system programmed to execute the 
me thod or methods described herein, and as a computer program 
product. According to the computer system «™s 
sets of instructions for executing the method or methods are 
resident in the random access memory 14 of one or more 
computer systems configured generally as ^ ih f 
Until retired by the computer system, the set of instructions 
ma y be stored as a computer program product in another 
computer memory, for example, in disk drive 20 (which may 
include a removable memory such as an optical disk or floppy 
disk for eventual use in disk drive 20) . Furthermore, the 
computer program product can also be stored at another 
computer and transmitted when desired to the user's work 
station by a network or by an external network such as the 
internet. One skilled in the art would appreciate that 
physical storage of the sets of instructions physically 

; t i, stored so that the medium 
changes the medium upon which it is storea 

carries computer readable information. The change may be 
electrical, magnetic, chemical or some other physical change. 



Figure 



„ Bw Tweeting ffn-nnrrP Exception Errors 



Figure 2 illustrates a flowchart of one embodiment of the 
present invention of a method 200 for detecting resource 
exception errors prior to the run-time of the application 42. 
As stated in the Background Information section, software 
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d evelo P ers .may not define a key-value pair in ^resource 
file e g., resource bundle, or mistype the key, i.e. free 

• ■„ .-ii-her the program code or the resource 
formatted string, in either tne piuy 

^ ^wpbv resulting in a resource exception 
file source code thereby resuiuxny 

error during the run-time of the application, e.g., Java 
eiiU . , rD f prrP d to as a method, 

That is, when a procedure, commonly referred to 

in ow attests to load an external sm» S fn. 

bundle and either the K.y-value pair is not defrned in the 

f . lp or the k ey in either the program code or 

"lor results. It would therefore be desirable to detect 
resource exception errors prior to the run-tin* of the 
application and subsequently define the key-value paxr ,n the 
Z urce file, e.g., resource bundle, or correct the mistyped 
In either the program cede or resource file source code so 
t avoid resource exception errors. Method 200 is a method 

n«„ errors orior to the run-time 
that detects resource exception errors prior 

of application 42. 

In step 210, a scanning program scans the code of an 

,o a n Tava line by line for a method 
aoDlication program 42, e.g., Java, ±ine jt 

location for opening a resource file, ..... resource bundle. 
» method -ay be defined as an object-oriented term for a 
procedure or function, one particular type of method «^ 
procedure that is used to open , resource file, ..... «so„>r 
bundle. » stated in the Background mfor.at.on sectron^ 
resource bundle class is an associative array of keys and 
vaiues. Keys are free formatted strings that appear in the 

,»n in the resource bundle thereby 
program code as well as m tne 

Lowing the program to access the e^™ 1 ^*'"™.^ 
Kxternali.ed strin.s may be represented as a value ass«r ed 
with the Key. The following code depicts a resource bundle 
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class definition written in Java code illustrating resources, 
i.e. key-value pairs, in a resource bundle. 

public call Res extends java.util.ListResourceBundle { 
static final Object [][] contents = { 
{ "Holiday Title", "Christmas" }, 
{ "Month Title", " December" } ; 
public Object [][] getcontents ( ) { 
return contents; 

} 

} 

in this code, "Holiday Title" and "Month Title»are the keys. 
The values associated with those keys are the text strxngs 
-Christmas" and "December", respectively. 

An example of resource files, e.g., resource bundles, 
comprising key value pairs is illustrated in Figure 3. Figure 
3 illustrates a plurality of resource files 310A-C where each 
resource file may be associated with a particular locale. For 
example, resource file 310A may be associated with a U.S. 
English locale. Resource file 310B may be associated with a 
German locale. Resource file 310C may be associated with a 
French locale. These resource files, e.g., 310A-C. may 
reside in a Java ARchive (JAR) file where the JAR file may 
reside in disk unit 20. Resource files 310A-C may 
collectively or individually be referred to as resource files 
310 or resource file 310, respectively. It is noted that any 
number of resource files may reside in a JAR file. 

Referring to Figure 3, resource file 310A illustrates the 
key-value pairs for the above illustrated Java code in the 
U s English locale. Resource file 310B associated with a 
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German locale may have the key values of "Weihnachten»and 
"Dezember" associated with the keys "Holiday Title" and "Month 

4-- r^.r Dpcmirce file 310C associated with a 
Title" respectively. Resource 

French' locale may have the key values of "Noel" and "decembre" 
associated with the keys "Holiday Title" and "Month Title", 
respectively. Hence, a resource file 310 may be defined for 
each locale an application 42 supports. The applicatxon 42 
e g Java, then loads the correct resource file 310 according 
to the specified locale. For example, if the application 42 
were running in the German locale, then when the interpreter 
translates the key "Holiday Title", resource file 310B is 

* accnri^pd kev value "Weihnachten" 

loaded into memory and the associated Key 

is outputted. 

An example of code, e.g., Java, that includes a method 
invocation to open a resource file, e.g., resource bundle, is 
shown below. 

rbCal=ResourceLoader.getBundle(»com.tivoli.uif. Resources. Calen 

darResources" ) ; _ 
S etTitle(ResourceLoader.getString(rbCal, "Holiday Title ); 

ResourceLoader is a subclass created from the abstract class 
ResourceBundle in Java. In the second line, getStringO is a 
method of the subclass that is used to open the resource 
bundle rbCal. The getStringO method in this subclass has two 
variables which will be discussed in greater detail below. 
Hence in step 210, the scanning program scans the code for a 
method invocation for opening a resource file, e.g., resource 
bundle It is noted that the getStringO method is exemplary 
only and that there are other method invocations for opening a 
resource file, e.g., resource bundle. 
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in step 220, a determination is made as to whether a 
method invocation was identified in step 210. If there was 
not a method invocation identified, then the scanning program 
generates a report in step 290 as will be described in greater 
detail below. 

If a method invocation was identified in step 220, then 
the scanning program in step 230 scans the code for a method 
signature, i.e. pointer, of the method invocation previously 
identified in step 210. In one embodiment, the method 
signature, i.e. pointer, may be the first parameter of the 
method invocation, e.g., getStringO method of the subclass 
ResourceLoader. The method signature, i.e. pointer, points to 
a resource file, e.g., resource bundle. In the above example 
of Java code, the method signature is rbCal which points to 
the resource bundle rbCal that is defined in the first line of 
the above code. The path name of the resource file, e.g., 
resource bundle, may be defined as a parameter in a method 
called getBundleO . In the subclass ResourceLoader of the 
abstract class ResourceBundle, the getBundleO method 
comprises one parameter that may be used for specifying the 
path name to the resource bundle. For example, in the above 
example of Java code, the path name to the resource bundle 
rbCal is "com.tivoli. uif. Resources. CalendarResources." Hence, 
the method signature rbCal points to the resource bundle rbCal 
and the resource bundle rbCal is loaded into memory via the 
getBundle ( ) method which uses the path name 
" com . tivoli . uif . Resources . CalendarResources . • 

In step 240, the scanning program scans the code for a 
pair of string delimiters adjacent to the method signature, 
i e pointer, identified in step 230. That is, the scanning 
program scans the code for a string variable associated with 
the method invocation identified in step 210. In one 
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embodiment, the string variable may be the second parameter of 
the invocation method, e.g., getStringO method of the 
subclass ResourceLoader. The string variable is a key of the 
resource file, e.g., resource bundle, that is pointed to by 
the method signature identified in step 230. For example, xn 
the above Java code, the string "Holiday Title" adjacent to 
the method signature rbCal is a key of the resource bundle 
rbCal . 

in step 250, the scanning program opens the resource 
file e g , resource bundle, identified by the method 
signature in step 230 using the method invocation identified 
in step 210, e.g., getStringO. In the above example Java 
code, the getStringO method of the subclass ResourceLoader 
may be used to open the resource bundle rbCal which was 
identified by the method signature, i.e. pointer, of rbCal. 
The path name of the resource bundle rbCal to be opened may be 
defined as a parameter of the getBundleO method used to 
define the resource bundle rbCal. 

in step 260, a determination is made by the scanning 
program as to whether the key string identified in step 240 as 
well as the value associated with that key is defined xn the 
resource file, e.g., resource bundle, identified in step 250. 
A determination as to whether the key identified in step 240 
is defined in the resource file, e.g., resource bundle, refers 
to determining whether the key identified in step 240 matches 
any of the key(s) (if any are defined) in the resource fxle, 
e g resource bundle, identified in step 250. If the 
resource file, e.g., resource bundle, does not comprise exther 
the key identified in step 240 or its associated value, then 
the scanning program detects a resource exception error in 
step 270. in one embodiment, the scanning program stores 
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resource exception errors detected that may later be printed 

out in a report in step 290. 

If the resource file, e.g., resource bundle, does 
comprise a key string identified in step 240 and the 
associated value, then a determination is made as .to whether 
there is more code to scan in step 280. If there is more code 
to scan, then, the scanning program continues to scan the code 
line by line for a method invocation for opening a resource 
file e g., resource bundle, in step 210. If there is no more 
code to scan, then the scanning report may generate a report 
in step 290. In one embodiment, the report generated may 
comprise a listing of all the resource .exception errors 
detected In another embodiment, the report may further 
comprise information as to the particular line (a) of code 
comprising keys to resource files, e.g., resource bundles, 
where the keys or values associated with the keys are not 
defined in the associated resource file, e.g., resource 
bundle. A software developer may then correct the mistyped 
keys in either the program code or resource file, e.g., 
resource bundle, source code or define the keys or values 
associated with the keys in the resource file, e.g. , resource 
bundle, thereby avoiding a resource exception error during the 
run-time of the application, e.g., Java. 

Upon detecting a resource exception error in step 270, a 
determination is made as to whether there is more code to scan 
in step 280. If there is more code to scan, then the scanning 
program continues to scan the code line by line for a method 
invocation for opening a resource file, e.g., resource bundle, 
in step 210. If there is no more code to scan, then the 
scanning report may generate a report in step 290. In one 

embodiment, the report generated may comprise a listing of all 
the resource exception errors detected. In another 
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embodiment, the report may further comprise information as to 
the particular line(s) of code comprising keys to resource 
files e g , resource bundles, where the keys or values 
associated with the keys are not defined in the associated 
resource file, e.g., resource bundle. A software developer 
may then correct the mistyped keys in either the program code 
or resource file, e.g., resource bundle, source code or define 
the keys or values associated with the keys in the resource 
file e g., resource bundle, thereby avoiding a resource 
exception error during the run-time of the application, e.g., 

Java . , . , . , 

It is noted that the scanning program may reside in disk 

unit 20 or application 42. It is further noted that the 

scanning program of the present invention may be implemented 

to detect resource exception errors in any type of programming 

language that has the capability of externalizing text strings 

in resource files. 

Although the method, computer program product and data 
processing system of the present invention is described in 
connection with several embodiments, it is not intended to be 
limited to the specific forms set forth herein, but on the 
contrary, it is intended to cover such alternatives, 
modifications, and equivalents, as can be reasonably included 
within the spirit and scope of the invention as defined by the 
appended claims. It is noted that the headings are used only 
for organizational purposes and not meant to limit the scope 
of the description or claims. 
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